@database BB-ConfTop
@master Coding:Sources/C/Tempest/BB-ConfTop/BB-ConfTop.guide
@$VER: v1.0b (02-05-96)
@author "BiLBo BaGGins/MoTioN"
@(c) "1996 MoTioN"
@wordwrap
@help "main"
@index main
@node "main" "Guide to BB-ConfTop v1.0b by BiLBo BaGGins/MoTioN"
@next "intro"
                                  _______ 
    _____________________________/______/_____ _____________ ____________
  __\________      /\______/    /____________/_\______/    /_\____      /
 /_____/____/     /____________/______/      /____________/______/     /__
           /_____/                   /______/tre!/(!            /_____//_/
                        -^-  Tempest Innovations  -^-
                              BB-ConfTop v1.0b
                         Code: BiLBo BaGGins/MoTioN
                      @{"
Introduction
" link "intro" 0}
                      @{"
Installation
" link "install" 0}
                      @{"           How to use           " link "usage" 0} 
                      @{"
Future Plans
" link "plans" 0}
                      @{"
Report
" link "bugs" 0}
                      @{"
Greetings
" link "greets" 0}
                      @{"
Motion
information  
" link "motion" 0}
                      @{"             Thanks             " link "thanks" 0} 
                      @{"         Latest updates         " link "update" 0}
                      @{"
" quit} 
@endnode
@node "intro" "-^- Introduction -^-"
@next "install"
@prev "main"
  BB-Conftop is a conference week top uploader door/util.
  Features:
  - shows name, location, bytes and files
  - run as util or door
  - external designs
  - writes results in a massmail
  - gives extra bytes to ConfTop winner
  - easy configuration
                            @{"
" link "main" 0}
@endnode
@node "install" "-^- Installation -^-"
@next "usage"
@prev "intro"
  Copy BB-ConfTop, BB-ConfTopConfig and BB-ConfTop.output.<x> to Doors:
  Start as door:
  --------------
  Edit your Optional/Bulletins.opt file:
  -------------------------> cut here <-------------------------
  [20-,*,*,*,*] =ctop  |T-DOOR|Tempest:Doors/BB-ConfTop
  [255,*,*,*,*] =ctopc |T-DOOR|Tempest:Doors/BB-ConfTopConfig
  -------------------------> cut here <-------------------------
  Edit your Describe/English/C_Area.<x> file(s):
  -------------------------> cut here <-------------------------
  ~CLS
                         AMIGA CONFERENCE
  ~TD(Doors:BB-ConfTop)
  -------------------------> cut here <-------------------------
  Start as util:
  --------------
  Edit your Optional/Bulletins.opt file:
  -------------------------> cut here <-------------------------
  [20-,*,*,*,*] =ctop  |PRINT|Tempest:Doors/BB-ConfTop
  [255,*,*,*,*] =ctopc |T-DOOR|Tempest:Doors/BB-ConfTopConfig
  -------------------------> cut here <-------------------------
  Edit your Scripts/Logoff.bat files:
  -------------------------> cut here <-------------------------
  Doors:BB-ConfTop <ConfigFile>
  -------------------------> cut here <-------------------------
  Edit your Describe/English/C_Area.<x> file(s):
  -------------------------> cut here <-------------------------
  ~CLS
                         AMIGA CONFERENCE
  ~SHOW_FILE(<Bulletin>)
  -------------------------> cut here <-------------------------
  Use ConfTopConfig:
  ------------------
  Enter "ctopc" for starting ConfTopConfig and configurating the ConfTop.
  First you have to enter the name of the configfile you want to edit/
  create. A default-name is given, that the door is trying to open:
  <ConfTopPath>BB-ConfTop.<Conf>.cfg
    ConfTopPath: Path of BB-ConfTopConfig.
           Conf: Conference BB-ConfTop is started from.
  When starting BB-ConfTop as door, it always tries to open the config-
  file with default-name. You can only use a custom name if you run it as
  util.
  After loading the configfile comes a menu with the following items:
  Global options:
  (A) Number of users in bulletin..............: 10
  (B) Number of the design to use..............: 1
  (C) Screenclear before bulletin..............: YES
  (D) Pause prompt after bulletin..............: YES
  Door only options:
  (E) Send massmail with results at end of week: YES
  (F) Number of users in massmail..............: 10
  (G) Give extra bytes to ConfTop winner.......: YES
  (H) Times extra bytes for ConfTop winner.....: 1
  Util only options:
  (I) Add nonstop toggle before bulletin.......: NO
  (J) Append bulletin to existing file.........: NO
  (K) Conference number........................: 12
  (L) Path & name of accounts.data.............:
      Tempest:Accounts.data
  (M) Path & name of bulletin..................:
      T:Test
  (N) Path & name of catalog.data..............:
      Tempest:Catalogs/Catalog_12.data
  Commands in the menu:
  A  Number of users to be displayed in the bulletin.
  B  The number of the design for the bulletin.
  C  Make screenclear before showing the bulletin.
  D  Make a pause prompt after showing the bulletin.
  E  Send massmail about the results of the week.
  F  Number of users to be written into the massmail.
  G  Give extra bytes to the winner of the ConfTop.
  H  Give x times extra credits of the uploaded bytes.
  I  Add a nonstop toggle (~+) in front of the bulletin.
  J  Append the bulletin to an existing file.
  K  The number of the conference for the bulletin.
  L  Path and name of the accounts.data.
  M  Path and name of the bulletin.
  N  Path and name of the catalog.data.
  S  Save and quit
  Q  Quit
  Edit the external designs:
  --------------------------
  The name of the external designfile must be:
  <ConfTopPath>BB-ConfTop.output.<Number>[.ansi|.amiga|.ibm]
    ConfTopPath: Path of BB-ConfTop.
         Number: Number of the design.
          .ansi: Extension for Ansi.
         .amiga: Extension for Amiga-Ansi.
           .ibm: Extension for Ibm-Ansi.
  The door looks for the ansitype of the user, tries to open the belonging
  designfile and displays it. If it can`t open the designfile it tries to
  open the ansi and than the non-ansi designfile.
  The util tries to open every designfile(s) and creates all bulletins.
  The datas are inserted into the keywords in the designfile(s).
  There are 2 types of keywords:
  1. Keywords with variable length and option to insert data to the left
     or right. The first character of it is always "@".
     They look like that: "@HANDLE=====....["
                                 /       |  \
                               a/       b|  c\
     a: Beginning of the keyword.
        (e.g.: "@HANDLE=====" for the username)
     b: Fillers. You can place as much fillers as long as you want to have
        the inserted data. A filler can be every character except "[" and
        "]".
        (e.g.: "....")
     c: Ending of the keyword. Must be "[" or "]". With "[" the data is
        inserted to the left and with "]" to the right.
  2. Keywords with given length and right inserted data.
     They look like that: "
  Structure of the designfile(s):
  The line(s) at the top are written between @TOP and @END.
  The line for the user is written after @LINE.
  The line(s) at the bottom are written between @BOTTOM and @END.
  Example:
  -------------------------> cut here <-------------------------
  @TOP
  ConfTop for Conference 
  @END
   @N] @HANDLE=========[ @LOCATION=======[ @ULBYTES====] @ULFI=]
  @LINE
  @BOTTOM
  Uploaded @ULBYTES====] Bytes in @ULFI=] Files.
  @END
  -------------------------> cut here <-------------------------
  Keywords for the user-line:
  "@N"             for the position.
  "@HANDLE====="   for the username.
  "@LOCATION==="   for the userlocation.
  "@ULBYTES===="   for the uploaded bytes.
  "@ULFI="         for the uploaded files.
  Keywords for top and bottom-lines:
"              for the day of the week.
"             for the conference number.
  "@ULBYTES===="   for the total uploaded bytes.
  "@ULFI="         for the total uploaded files.
  "@THANDLE===="   for the record week top uploader username.
  "@TLOCATION=="   for the record week top uploader userlocation.
  "@TULBYTES==="   for the record week top uploader uploaded bytes.
  "@TUFI="         for the record week top uploader uploaded files.
  "@LHANDLE===="   for the last week top uploader username.
  "@LLOCATION=="   for the last week top uploader userlocation.
  "@LULBYTES==="   for the last week top uploader uploaded bytes.
  "@LUFI="         for the last week top uploader uploaded files.
                            @{"
" link "main" 0}
@endnode
@node "usage" "-^- How to use -^-"
@next "plans"
@prev "install"
  User can`t do anything except reading it.
                            @{"
" link "main" 0}
@endnode
@node "plans" "-^- Future Plans -^-"
@next "bugs"
@prev "install"
  Currently nothing is planned with this tool.
                            @{"
" link "main" 0}
@endnode
@node "bugs" "-^- Bug Report -^-"
@next "greets"
@prev "plans"
  No known Bugs at the moment. If you find some try to contact me on Deep
  Space Nine, Sado City , Dawn of Eternity or irc.
                            @{"
" link "main" 0}
@endnode
@node "greets" "-^- Greetings flow out to -^-"
@next "motion"
@prev "bugs"
                        my personal greetings go to
                        
   Agent - AMO/ORS - APEX - BBC/M! - Ben/M! - Bezzzerk/M!^MXM - Calypso/LGC
    Castor - cOUGAR/HLM - Deathknight/PSG - Demax^Agressor/DLT - dONALD/M!
    Dr. Dre/TRSI - Duke/M! - ECS/TRSI - E.F.A./M! - Fnord/M! - Fury/M!^PSG
      Intercode/BB - JAF - Joker - Juan/TRSI - Kingpin/M! - Lenny Dee/HF
       Logic/M! - Mario/TRSI - Marky&Power/BLH - Mogue/AL - Mr.Solo/RNX
    Pitch/QTX - Playmate/M! - Princip/M! - Pyro/HF - Relief/oS - Rhetor/M!
    sCANDIC/M! - SchwabenPower/M! - Shane/CRX - Shapechanger/AL - Sisko/M!
      Skeleton - Skywalker - sLIME/M! - sNIKE - Spider/ORS - Striker/PSG
    The Addict/M! - Tom - tRAITOR/M! - Treach/C! - Vampire/TRSI - Zinko/PB
                        all MoTioN members worldwide
                      and all the rest I have forgotten
                            @{"
" link "main" 0}
@endnode
@node "motion" "-^- MoTioN iNFORMATION -^-"
@next "thanks"
@prev "greets"
                       the crazy ones behind Motion are 
                       
               BBC 
 Ben 
 Bezzzerk 
 BiLBo BaGGins 
 Bloodwolf
         Bowen 
 Disque Bleu 
 Donald 
 Duke 
 E.F.A. 
 Fnord 
 Fury
                KiNGPin 
 lOGIC 
 pLaYmAte 
               pRINCIP 
 Rhetor 
 RTD 
 sCANDIC 
 SchwabenPower
            sISKO 
 sLIME&vOYAGE 
 tHE aDDICT 
 tRAITOR 
 Wendigo
                       call our crazy boards worldwide
                       
             WHQ....Mortuary................+1-aSK-fOR-iT!...6nDZ
             EHQ....Deep
Space
Nine........+49-aSK-fOR-iT!...6nDZ
             GHQ....FastFileSystem.........+49-aSK-fOR-iT!...9nDZ
             SWIHQ..Dial Hard..............+41-aSK-fOR-iT!...5nDZ
             SHQ....Interchange............+46-aSK-fOR-iT!...3nDZ
             OZHQ...Dark Sun...............+61-aSK-fOR-iT!...3nDZ
             DKHQ...Northern Palace........+45-aSK-fOR-iT!...3nDZ
             NHQ....Checkpoint.............+47-aSK-fOR-iT!...2nDZ
                            @{"
" link "main" 0}
@endnode
@node "thanks" "-^- Thanks -^-"
@next "update"
@prev "motion"
                Many thanks must go to my following betatesters
                                   sISKO
                                 ] Joker [
                                   E.F.A.
                                  Treach!
                                    AMO
                                   sNIKE
                                 Intercode
                                 The Bird
                      for all the bugreports and ideas.
                            @{"
" link "main" 0}
@endnode
@node "update" "-^- Latest updates -^-"
@prev "thanks"
  You can get the latest updates from all my tools/doors on Deep Space
  Nine. Just ask me on irc to get an account. 
                            @{"
" link "main" 0}
@endnode